package com.time.admin.infra.basic.service;

import com.time.admin.infra.basic.entity.Post;

import java.util.List;

/**
 * 文章表(Posts)表服务接口
 *
 * @author HuangQi
 * @since 2025-09-30 16:57:20
 */
public interface PostService {

    /**
     * 通过ID查询单条数据
     *
     * @param postId 主键
     * @return 实例对象
     */
    Post queryById(Long postId);

    /**
     * 分页查询
     *
     * @param posts    筛选条件
     * @param start    起始位置
     * @param pageSize 分页大小
     * @return 查询结果
     */
    List<Post> pageQueryByCondition(Post posts, int start, int pageSize);

    /**
     * 条件分页查询-分类类型
     *
     * @param post       筛选条件
     * @param categoryId 分类ID
     * @param start      起始位置
     * @param pageSize   分页大小
     * @return 查询结果
     */
    List<Post> pageQueryByCategoryId(Post post, Long categoryId, int start, int pageSize);

    /**
     * 新增数据
     *
     * @param post 实例对象
     * @return 实例对象
     */
    Integer insert(Post post);

    /**
     * 修改数据
     *
     * @param post 实例对象
     * @return 实例对象
     */
    Integer update(Post post);

    /**
     * 通过主键删除数据
     *
     * @param postId 主键
     * @return 删除行数
     */
    Integer deleteById(Long postId);

    /**
     * 获取符合条件的数据条数
     *
     * @param post 筛选条件
     * @return 数据条数
     */
    Integer count(Post post);

    /**
     * 根据条件获取符合条件的文章数量
     *
     * @param post 筛选条件
     * @return 文章数量
     */
    Integer countByCondition(Post post);

    /**
     * 根据条件和分类id获取符合条件的文章数量
     *
     * @param post       筛选条件
     * @param categoryId 分类id
     * @return 文章数量
     */
    Integer countByCategoryId(Post post, Long categoryId);
}
